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1 Introduction 


Fimfarchive is a project which aims to release all stories available on Fimfiction, together with 
their metadata, as a single archive. The archive is organized by author and could be used for 
backup, offline reading, or data mining. 

A new version will be released each season via BitTorrent, approximately once every three 
months. When suitable, an xdelta3 patch will also be provided for users who do not wish to 
redownload unchanged stories. 

Note that the archive contains a large number of files. Unzipping it to your file system 
may not be necessary if the archive is to be used together with some application. If you are a 
developer, reading directly from the ZIP-file may be preferable. 


2 Index 


The metadata of each story can be found in index.json. The file contains one story entry 
per line ordered by story ID. It was constructed using data from the Fimfiction API, which is 
incomplete. Additionally, each entry includes the attribute archive.path which shows where 
in the archive the story is located. Below is an example entry for the story Sunny Skies All 
Day Long. Note that the structure of the metadata may change in the future. 


{ 
"archive": { 
"date_checked": "2017-11-03T12:03:47.175215+00:00", 
"date_created": null, 
"date_fetched": "2017-11-03T12:03:47.175215+00:00", 
"date_updated": "2017-11-03T12:03:47.175215+00:00", 
"path": "epub/p/phantomfox-26190/sunny_skies_all_day_long-20685.epub" 


Fo 
"author": { 
"avatar": { 
"128": "https://cdn-img.fimfiction.net/user/p8d8-1431820610-26190-128", 
"16": "https://cdn-img.fimfiction.net/user/p8d8-1431820610-26190-16", 
"192": "https://cdn-img.fimfiction.net/user/p8d8-1431820610-26190-192", 
"256": "https://cdn-img.fimfiction.net/user/p8d8-1431820610-26190-256", 
"32": "https://cdn-img.fimfiction.net/user/p8d8-1431820610-26190-32", 
"384": "https://cdn-img.fimfiction.net/user/p8d8-1431820610-26190-384", 
"48": "https://cdn-img.fimfiction.net/user/p8d8-1431820610-26190-48", 
"512": "https://cdn-img.fimfiction.net/user/p8d8-1431820610-26190-512", 
"64": "https://cdn-img.fimfiction.net/user/p8d8-1431820610-26190-64", 
"96": "https://cdn-img.fimfiction.net/user/p8d8-1431820610-26190-96" 
F; 
"bio_html": "", 
"date_joined": "2012-04-13T19:09:19+00:00", 
"id": 26190, 
"name": "PhantomFox", 
"num_blog_posts": 1, 
"num_followers": 699, 
"num_stories": 3, 
"url": "https://www.fimfiction.net/user/26190/PhantomFox" 
rs 
"chapters": [ 
{ 


"chapter_number": 1, 

"date_modified": "2012-09-26T17:27:44+00:00", 

"date_published": "2012-09-26T17:27:44+00:00", 

"id": 63408, 

"num_views": 86994, 

"num_words": 8536, 

"published": true, 

"title": "Chapter 1", 

"url": "https://www.fimfiction.net/story/20685/1/sunny-skies-all-day-long/ 


chapter-1" 
} 
1, 
"color": { 
"hex": "dfbeae", 
"rgb": [ 
223, 
190, 
174 
] 
}, 
“completion _status'": "complete", 
“content _rating": "everyone", 


"cover image": { 

"full": "https://cdn-img.fimfiction.net/story/5c7h-1432428695-20685-full", 
"large": "https://cdn-img.fimfiction.net/story/5c7h-1432428695-20685-large", 
"medium": “https://cdn-img.fimfiction.net/story/5c7h-1432428695-20685-medium", 
"thumbnail": "https://cdn-img.fimfiction.net/story/5c7h-1432428695-20685-tiny" 

a 

"date_modified": null, 

"date_published": "2012-04-14T14:42:21+00:00", 

"date_updated": "2012-04-14T14:42:21+00:00", 

"description_html": "<p>Princess Celestia tires of constantly being surrounded by 
decorum, deference, and formality, and decides to take a day off from being 
Princess. But visiting Ponyville incognito is harder than she expects. Will 
she be able to fit in and make friends without blowing her cover?</p>", 

"id": 20685, 

"num_chapters": 1, 

"num_comments": 773, 

"num_dislikes": 140, 

"num_likes": 8796, 

"num_views": 86994, 

"num_words": 8536, 

"prequel": null, 

"published": true, 


"rating": 98, 
"short_description": "Celestia’s Day Off", 
"status": "visible", 
"Submitted": true, 
"tags": [ 
{ 
"id": 73, 
"name": "Main 6", 


"old_id": "c:74", 


"type": "character", 
"url": "https://www.fimfiction.net/tag/main-6" 


F; 
{ 
"id": 16, 
"name": "Princess Celestia", 
"old_id": "c:17", 
"type": "character", 
"url": "https://www.fimfiction.net/tag/princess-celestia" 
Fs 
{ 
"id": 237, 
"name": "Slice of Life", 
"old_id": "g:slice_of_life", 
"type": "genre", 
"url": “https://www.fimfiction.net/tag/slice-of-life" 
} 
l, 


"title": "Sunny Skies All Day Long", 
"total_num_views": 86994, 
"url": "https://www.fimfiction.net/story/20685/sunny-skies-all-day-long" 


3 Changelog 

















































































































Version | Stories | Added | Updated | Removed 
20210301 | 194575 2229 4424 0 
20201201 | 192346 2277 4573 2 
20200901 | 190071 2019 4762 0 
20200601 | 187552 2653 4999 0 
20200301 | 184899 2429 4626 0 
20191201 | 182470 2805 4824 0 
20190901 | 179665 2484 5016 9 
20190601 | 177190 2736 5058 45 
20190301 | 174499 2563 5111 0 
20181201 | 171936 2858 5359 0 
20180901 | 169078 2667 5603 0 
20180601 | 166411 2980 6061 0 
20180307 | 163431 3322 7872 0 
20171203 | 160109 3261 110426 0 
20170907 | 156848 3301 5202 0 
20170601 | 153547 3644 5265 0 
20170301 | 149903 4608 5632 0 
20161201 | 145295 4582 5685 0 
20160901 | 140713 5278 6106 0 
20160525 | 135435 5059 6238 0 
20160225 | 130376 6045 6569 0 
20151125 | 124331 5399 104124 0 
20150901 | 118932 6752 6752 0 
20150601 | 112180 6969 6946 0 
20150307 | 105211 6664 6756 0 
20141201 98547 11028 8296 0 
20140719 87519 8286 7395 3 
20140418 79236 8818 65208 2 
20140120 70420 9821 7317 14 
20131015 60613 13446 7694 0 
20130616 47167 | 47167 0 0 





3.1 20210301 


e Updated archive contents. 


3.2 20201201 


e Updated archive contents. 


3.3 20200901 


e Updated archive contents. 


3.4 20200601 


e Updated archive contents. 





3.9 


3.6 


3.7 


3.8 


3.9 


20200301 


Updated archive contents. 


20191201 


Updated archive contents. 


20190901 
Updated archive contents. 


Fixed author ID sometimes being a string. 


20190601 


Updated archive contents. 


Rewrote the builder. 


20190301 


Updated archive contents. 


Fixed inconsistency in completion status. 
(Reported by Midnight Sapphire) 


3.10 20181201 


Updated archive contents. 


3.11 20180901 


Updated archive contents. 


3.12 20180601 


Updated archive contents. 


3.13 20180307 


Updated archive contents. 


3.14 20171203 


Updated archive contents. 
Redownloaded all available stories. 
Changed to Fimfiction APIv2. 
Added archive metadata. 


Added author’s notes. 


3.15 20170907 


e Updated archive contents. 


3.16 20170601 


e Updated archive contents. 


3.17 20170301 


e Updated archive contents. 
e Added wordless stories. 


e Rewrote the updater. 


3.18 20161201 


e Updated archive contents. 


3.19 20160901 


e Updated archive contents. 


3.20 20160525 


e Updated archive contents. 


3.21 20160225 


e Updated archive contents. 


3.22 20151125 


e Updated archive contents. 


e Redownloaded all available stories. 


e Processed all stories with Calibre. 


e Removed readme section about formatting. 


3.23 20150901 


e Updated archive contents. 


3.24 20150601 


e Updated archive contents. 


3.25 20150307 


e Updated archive contents. 


e Added readme section about formatting. 


3.26 20141201 


e Updated archive contents. 


e Changed EPUB content source to Fimfiction’s HTML exporter. 


3.27 20140719 


e Updated archive contents. 


3.28 20140418 


e Updated archive contents. 
e Redownloaded all available stories. 


e Fixed mime type issues with repackaged stories. 


3.29 20140120 


e Updated archive contents. 
e Updated stories with new style from Fimfiction. 


e Removed now empty stories. 


3.30 20131015 


e Updated archive contents. 


e Added anthro category. 


3.31 20130616 


e Initial release. 


4 Links 


e Fimfarchive: 
http://www.fimfarchive.net/ 


e Fimfarchive on Fimfiction: 
http://www.fimfiction.net/user/Fimfarchive 


e Fimfarchive on Reddit: 
http://www.reddit.com/user/Fimfarchive 


e Fimfiction: 
http://www.fimfiction.net/ 


e xdelta: 
http://xdelta.org/ 


5 Contact 


To contact Fimfarchive, send an e-mail to fimfarchive@gmail.com. 
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